街灯内存速览 —— 安装与使用说明


━━━ 这是什么 ━━━

  一个常驻 Mac 菜单栏的小工具。
  把「活动监视器」里最常看的「内存」和「能耗」做成随时能瞄一眼的小面板，
  不用再开那个占半个屏幕的大窗口。

  长什么样可以看旁边的「面板预览.png」。


━━━ 一、安装（约 30 秒）━━━

  1. 把「街灯内存速览.app」拖到「应用程序」文件夹里
  2. 双击打开它


━━━ 二、⚠️ 第一次打开会被系统拦一下（重要）━━━

  会看到类似「无法验证开发者」或者「已损坏，无法打开」的提示。

  这是正常的，不是软件有问题 —— 只是因为这个小工具没有花钱买
  苹果的开发者签名证书（一年 99 美元）。任何个人自己做的、
  没上架 App Store 的 Mac 软件，第一次打开都是这个待遇。

  （如果这个压缩包是用 U 盘 / 移动硬盘拷给你的，可能不会被拦，
    那就直接跳过这一段。）

  放行办法一（推荐，点几下鼠标）：

    打开「系统设置」→「隐私与安全性」→ 往下滚动，
    会看到一行「已阻止使用"街灯内存速览"...」
    → 点右边的「仍要打开」→ 再确认一次

  放行办法二（上面那行找不到，或者点了没反应时用）：

    打开「终端」App，把下面这行原样粘贴进去，按回车：

      xattr -dr com.apple.quarantine "/Applications/街灯内存速览.app"

    然后再双击打开就好了。

  ★ 放行只需要做这一次，以后再也不会问。


━━━ 三、怎么用 ━━━

  打开之后不会弹出任何窗口，这是正常的 —— 它住在菜单栏里。

  看屏幕右上角，会多出一个小条形图 + 百分比。条形图会随内存压力变色
  （绿 = 正常，黄 = 警告，红 = 严重）。

    · 左键点它   → 展开面板
    · 右键点它   → 设置
    · 鼠标悬停   → 不用点开就能看到完整数值

  面板里从上到下是（对照「面板预览.png」看）：

    · 已使用内存 / 物理内存总量，右上角是内存压力状态
    · 彩色分段条：App 内存 · 联动内存 · 被压缩 · 已缓存文件
      —— 一眼看出内存被谁占了
    · 曲线：内存使用率的走势
    · 内存压力 · 交换空间 · CPU 总占用
    · 进程列表：可以在「内存占用」和「能耗」之间切换，
      揪出最占内存 / 最耗电的那几个

  在进程上点右键，可以复制它的名字，或者结束 / 强制结束它（都有二次确认）。


━━━ 四、设置（右键点菜单栏图标）━━━

    · 菜单栏显示什么：条形图+百分比 / 仅百分比 / 仅已用容量 / 仅条形图
    · 百分比的含义：内存使用率 或 内存压力
    · 要不要顺带显示 CPU 占用、要不要用单色图标
    · 刷新频率：1 / 2 / 3 / 5 秒
    · 进程列表长度：5 / 8 / 12 个
    · 开机时自动启动


━━━ 五、数字准不准 ━━━

  内存部分和活动监视器同源，不是估算：数据取自系统的 host_statistics64，
  进程内存用的是实际占用（phys_footprint），和活动监视器「内存」那一列
  是同一个口径。「联动内存」「被压缩」两项和系统 top 命令的输出逐位一致。

  能耗是近似值。苹果的「能量影响」计算公式没有公开，系统也没开放接口，
  这里用「CPU 占用 + 空闲唤醒加权」来近似，量级和活动监视器接近，
  用来揪耗电大户够用，但数值不会完全相等。
  列表里带 ~ 的灰色条目是系统进程，数值来自 ps，仅供参考。


━━━ 六、占多少资源 ━━━

  它自己大约占 20 MB 内存，CPU 接近 0。
  面板收起时只做两次系统调用；只有展开面板时才会去枚举进程，关掉就停。


━━━ 七、怎么卸载 ━━━

  菜单栏图标右键 →「退出」，
  然后把「应用程序」里的「街灯内存速览.app」拖进废纸篓就行。
  它不往系统里装任何东西。


━━━ 八、系统要求 ━━━

  macOS 12 或更新版本。
  Apple 芯片（M 系列）和 Intel 芯片的 Mac 都支持（通用二进制）。
